home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / mr2.zip / MR2.DOC < prev    next >
Text File  |  1992-01-03  |  10KB  |  219 lines
  1. MR/2 - A QWK Compatible Mail Reader for OS/2
  2.  
  3. Copyright (c) 1992, Knight Writer Software Company.
  4. All rights reserved.
  5.  
  6. ===================================================================
  7.                          N O T I C E
  8. ===================================================================
  9.  
  10. This is beta-level software and is incomplete and may still contain
  11. significant bugs. Please report any and all problems to the author.
  12. Various addresses are provided at the end of this document.
  13.  
  14. The standard "I'm not responsible" disclaimer applies - I'll supply a
  15. real one here eventually.  You know how it goes.
  16.  
  17. This IS a shareware package, and does require a registration fee if you
  18. choose to continue using it after 30 days.  At this time, since it is
  19. incomplete and buggy, I'll extend the trial period to 60 days.  By then
  20. I'll have released a "finished" 1.0 version (finished by my definition).
  21. The registration fee will be initially set at $12.   The final product
  22. will have a "begging" screen with a key-file that will register the
  23. software and suppress it.  I won't be chasing anyone down for not
  24. paying, but the more interest I get, the more likely I am to continue
  25. with improvements.
  26.  
  27.  
  28. ===================================================================
  29.                     IF MR/2 SHOULD CRASH
  30. ===================================================================
  31.  
  32. All is not lost (at least I hope not).  Just go back into MR/2 and
  33. respond with the ENTER key when asked if you wish to use the existing
  34. packet.  If your last reply is missing (this happens if the crash is due
  35. to a reply being filed), use the "X" command while viewing any message
  36. to "Fast Exit" MR/2.  Check for Reply.Msg in the MR2 software directory
  37. and save it somewhere - this SHOULD be your missing reply.  Reply to the
  38. original message again and, once in your editor, use this saved file to
  39. respond.
  40.  
  41. These problems (with replying) should be cleared up before I let MR/2
  42. out.  Still, only testing and time will tell for sure.
  43.  
  44.  
  45. PRELIMINARY DOCUMENTATION
  46. =========================
  47.  
  48. Unpack the MR2.ZIP file into an appropriate directory ("\MR2", for
  49. instance).  All MR/2 files should be kept together in the same
  50. directory.  You must invoke MR/2 only while pathed into this directory -
  51. this is the only way that MR/2 will be able to find its supporting
  52. files.
  53.  
  54.  
  55. INSTALLATION
  56. ============
  57.  
  58. Unpacking MR2.ZIP is all that's involved in installing MR/2.  You may
  59. choose to create and edit an ".ini" parameter file for MR/2.  This file
  60. may be used to set up various run-time options.  A template file,
  61. "MR2INI.ORG" is provided that provides examples of all available
  62. parameters along with some explainations.
  63.  
  64. NOTE:  When MR/2 is invoked for the very first time (actually, any time
  65. where the file "MR2.INI" is not found), it will allow for creation of
  66. this file. A short prompt will ask for your permission, and if given,
  67. the file "MR2INI.ORG" will be copied to "MR2.INI", and the OS/2 system
  68. "E" editor will be loaded, ready for you to make any desired
  69. modifications.  Once the editor is exited, you will see the MR/2 packet
  70. selection screen.
  71.  
  72. It is very important to identify the correct "packet path" in the
  73. MR2.INI file. This must identify the directory in which all your .QWK
  74. packets are kept. MR/2 includes no provisions for changing the "packet
  75. path" on demand, short of modifying the .ini file and reloading.
  76.  
  77. The initial MR2.INI file contains documentation on each option.  Examine
  78. and set these options carefully to fit your specific needs.
  79.  
  80.  
  81. GENERAL
  82. =======
  83.  
  84. Simple help screens are available at any time by depressing F1 (or by
  85. pressing the middle button on a three-button mouse).  If you find a spot
  86. where HELP is unavailable, please report this to the author. The package
  87. was initially tested under OS/2 1.3, however, most later development and
  88. testing were performed using 2.0 beta versions 6.149 and 6.167.
  89.  
  90. MR/2 was written in C++, using Zortech's 3.0 release.  I used many of
  91. the class "tools" provided by Zortech, most of which I had to modify in
  92. one form or another.  Source code is not available, however, I will
  93. gladly offer assistance to anyone wishing to write their own reader.
  94.  
  95. I've modeled this reader, at least somewhat, after the MS-DOS SLMR
  96. reader. It works in a similar manner, and many keystroke functions are
  97. the same.  Before I wrote MR/2, SLMR was my reader-of-choice, and I
  98. found it to meet my needs nicely.
  99.  
  100. That's it for now as far as documentation goes.  I'll supply a better
  101. manual at a later date.  I may even check for spelling errors.    You'll
  102. have to try it to learn it.
  103.  
  104.  
  105. KNOWN BUGS AND STUFF - 01/03/92
  106. ===============================
  107.  
  108. Mouse support is broken.  It works sometimes under the 6.149 beta, but
  109. is totally broken under 6.167.
  110.  
  111. The TEMPORARY directory MUST remain a subdirectory of the MR2 home dir.
  112.  
  113. I don't supply an editor.  You'll have to find your own or use E or EPM.
  114. QEdit for OS/2 works nice as an inexpensive, character-mode editor
  115.  
  116. The packet path is also assumed to be the reply packet path.  Your reply
  117. packets will be placed in with your .qwk mail packets.
  118.  
  119. No FIND under NEWS - NEW FILES - BULLETIN file viewing yet.  Works from
  120. within message viewing, though.  You also cannot search through all messages
  121. in all conferences with one command.
  122.  
  123. Many .ini file parameter ideas are unfinished.  Some haven't even been
  124. started.
  125.  
  126. No tagline file, selection or automatic rotation.  A single tagline is
  127. specified in the .ini file.  You can modify the tagline while editing a
  128. message header, but any changes made will be remembered during that session
  129. only.  MR/2 reads the default tagline from the .ini file each time it loads.
  130.  
  131. No "save file" selection - a single save file is used, the name of which
  132. is specified in the .ini file. (default is "save.txt")
  133.  
  134. Failed packing/unpacking tends to dump you on the command line.
  135.  
  136. You can't sort any of the selection lists.
  137.  
  138. No delete/rename function has been provided for packets.  You'll have to
  139. go the the command line for this.
  140.  
  141. No "bookmark" mechanism is provided.  MR/2 won't know where you left off
  142. when you reenter a packet.  Also, marking messages as read, replied and
  143. saved is implemented, but these flags are lost when you close a packet.
  144. Subsequent reading of the same packet will not benefit from previous
  145. flag settings.
  146.  
  147. I've tested MR/2 with Markmail and somewhat with QMail packets.  Others
  148. are untested.
  149.  
  150. You can't send ADD/DROP conference messages yet.  This seems easy enough,
  151. so I should be able to add it in soon.
  152.  
  153. ANSI support is not provided for messages or file viewing and @variables
  154. are not converted.  Sorry, maybe later.
  155.  
  156. Long replies (over 100 lines) are not split.  I need more information as
  157. to when this might be a problem.
  158.  
  159. Other frills that have not yet been addressed:  Bulk marking, forwarding
  160. messages, carbon copies, creating replies without having a source packet,
  161. twit filter, sorted selection lists, function key assigning, changing the
  162. packet path on demand.  There are probably others.  Feel free to bombard
  163. me with requests.
  164.  
  165. You can't yet edit the .ini file via keypress from within MR/2 (no SLMR
  166. ALT-C key).
  167.  
  168. Help files will be merged into a single .hlp file.
  169.  
  170. Quoting style is limitted to the one I use.  I'll add some others
  171. eventually.
  172.  
  173. When you kill a reply, the message remains visible but is displayed with
  174. a "KILLED" status - it is NOT removed from view.  If you load the replies
  175. again later, the killed messages will not be displayed.  Killed messages
  176. can be saved to a file, and can also be unkilled by editing the reply
  177. (any time you use "R" to reply to a reply, you actually edit the original
  178. reply).
  179.  
  180. Any ideas on how to effectively use multithreading would be appreciated.
  181.  
  182. No long file name support.  Since QWK is a DOS thing, the only place I can
  183. see using it is for packet names (if the user renames it).  Any ideas?
  184.  
  185.  
  186. CONTACTING THE AUTHOR
  187. =====================
  188.  
  189. You can contact me in a number of ways.  Unfortunately, I can't provide
  190. a phone number at this time.
  191.  
  192.         US Mail:        Nick Knight
  193.                         1823 David Ave.
  194.                         Parma, Ohio 44134
  195.  
  196.         Fido netmail:   1:157/2 to "Nick Knight"
  197.  
  198.         Fido Echomail:  Echomail messages to me are discouraged, as
  199.                         keeping them "on topic" and interesting to
  200.                         the masses would be difficult.  I do read OS2,
  201.                         OS2PROG, C_PROGRAMMING, C_PLUSPLUS and DR DEBUG
  202.                         daily, though.  OFFLINE echo also (deals with
  203.                         mail readers), this might be THE place to ask
  204.                         public questions, eh?
  205.  
  206.         Direct BBS:     Leave a message on the Nerd's Nook BBS (157/2)
  207.                         at (216) 356-1772, 356-1882 or 356-1431.
  208.                         I check in here multiple times a day.  I will
  209.                         also keep the most recent copy of MR/2 posted
  210.                         here.  Other boards (non-local) will get updates
  211.                         at my convenience.
  212.  
  213.                         Optionally, I call into PC-OHIO regularly.
  214.  
  215.         Compuserve:     I check in here only when I have to.  Try
  216.                         mail to my user ID - 76066,1240, although this
  217.                         isn't the best approach.
  218.  
  219.